home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Newton / X-Master 2.0 ƒ / X-Master 2.0 READ ME < prev    next >
Encoding:
Text File  |  1994-10-19  |  9.2 KB  |  170 lines  |  [TEXT/R*ch]
  1. X-Master v 2.0
  2.  
  3. ==============================================================================
  4. Copyright © 1994 Ricardo Guerra, Jr. & Impossible Dreams, All Rights Reserved.
  5. This utility can be copied but is copyrighted. You may make copies for others as
  6. long as no charge is involved (other than for electronic media or transfer
  7. costs) and this document is included. However, making copies for any commercial
  8. purpose is prohibited without express written permission from the author.
  9. ==============================================================================
  10.  
  11. Thanks for downloading X-Master!
  12.  
  13. X-Master is a Newton utility which allows you to quickly and easily launch
  14. applets, books, and built-in functions without ever opening the Extras drawer.
  15. It is unobtrusive and simple to use.  X-Master's basic design is similar to
  16. launching utilities such as Now Utilities NowMenus™ for the Macintosh which
  17. provides a popdown list of applications and documents to open.
  18.  
  19. INSTALLING X-MASTER: Use the Newton Connection Kit or Package Installer utility
  20. to load the package into your Newton.  X-Master is relatively small (roughly 14K
  21. after installation) and therefore can be loaded into either internal memory or 
  22. onto a storage card.
  23.  
  24. After installation, you will see a small dot in the upper right hand corner of
  25. your screen.  The position (left or right side) of the dot is user configurable
  26. as described below.  X-Master will automatically restart itself after resets or
  27. card swaps from this point on.
  28.  
  29. USING X-MASTER: X-Master is easy to use.  Simply tapping on the dot will display
  30. a popdown menu of all the USER INSTALLED applets and Newton Books in either 
  31. alphabetical order or the order in which they were installed (user-configurable).
  32. Selecting an item from the list will open that app or book (or, if the app is 
  33. already open, it will be closed).  To open BUILT-IN FUNCTIONS (eg., In Box, Prefs,
  34. Time Zones, Styles, etc.), touch the dot and hold for about 2 seconds. At that
  35. point you will hear a beep.  Lift the stylus from the dot and a popdown list of
  36. the BUILT-IN apps will appear.  Selecting from this list will launch the desired
  37. function.  In either case, simply clicking anywhere outside the popdown list will
  38. dismiss the menu.  By holding for a bit longer until a warble sound is produced will
  39. invoke the Preferences/About Box dialog.
  40.  
  41. X-Master can ALSO be popped down by tapping AND holding on the Extras Button until
  42. you hear a plink sound (user-installed list), holding longer for a double-plink
  43. sound (Built-In apps), or holding a bit longer until a warble sound is produced 
  44. (Preferences/About Box).
  45.  
  46. These options can be configured from the Preferences/About Box.
  47.  
  48. **** MULTIMENUS ****
  49. X-Master can list ANY NUMBER of items that have been installed in the X-tras drawer!
  50. To do this, it uses what I call "MultiMenus".  While not scrolling menus, per se,
  51. the MultiMenu feature will allow the display of any number of items in a standard
  52. Newton popdown menu.  If the number of items in the applet list is larger than can be 
  53. displayed in one screen, you will see down arrows at the end of the menu.  Selecting
  54. the arrows will result in another menu which displays the remainder of the list.  
  55. Tapping on the up arrows will return you to the previous portion of the list.  Please
  56. let me know if you like this feature on the Newton system since it may be possible
  57. for me to generalize it or extend it to be even more useful.  As always, ideas are
  58. welcome!
  59.  
  60. EXTRAS BUTTON POPUP
  61. If you don't like the little dot in the upper corners, you can popup the X-Master 
  62. list by tapping AND holding briefly on the Extras Button untill you here a "plink"
  63. sound.  The USER-INSTALLED list will drop down for use.  For the BUILT-IN apps,
  64. tap AND hold until you hear the double plink sound.  To popup the about box/prefs
  65. dialog, hold the stylus on the button until the warble sound occurs.  You can then
  66. configure X-Master to hide the corner dots and be accessed solely through the 
  67. Extras Button.
  68.  
  69. If you install X-Master on your storage card and try to remove the card while
  70. X-Master is OPEN, the Newton will ask for the card back.  This will occur with
  71. ANY Newton program that is running from an ejected card.  To safely remove the
  72. card, simply select X-Master from the popdown list or tap its icon in the extras
  73. drawer to toggle it closed.  Then the card can be removed.  X-Master will
  74. automatically reopen itself when the card is placed back into a Newton.
  75.  
  76. X-Master has been tested on an MP Classic, 100, and 110 with no problems noted.
  77. However, in the rapidly changing Newton world, it's difficult to test for all
  78. possible situations.  As always, one should back up your PDA before trying out
  79. new software.
  80.  
  81. SETTING USER PREFERENCES & ABOUT X-MASTER: X-Master allows a user to set several
  82. features.  You can set the side in which it appears to enhance ease of use for 
  83. left handed Newton owners.  The ORDER of the USER-INSTALLED items can be set to
  84. be either alphabetical or by order installed.  You can also set whether the X-Master
  85. menu pops up by tapping on the Extras Button AND/OR tapping the dot in the upper
  86. corners.  To invoke the preferences dialog (which doubles as the About X-Master box),
  87. tap and hold your stylus on the dot OR the Extras button.  After about 2 seconds 
  88. you will hear a beep. Continue holding for about 2 more seconds.  You will then hear 
  89. a warble sound. Lift your stylus AFTER the second sound -- a dialog box will appear.
  90. There are several radio buttons and checkboxes at the bottom of the dialog.  Select
  91. the desired display options. 
  92.  
  93. The dialog box also contains shareware information and eMail/Snail Mail
  94. addresses for the author.  Tapping on the Impossible Dreams Star logo will
  95. display acknowlegements to some special people.  Tapping the star again will
  96. toggle back to the original notice.  Tap on the close box to dismiss the dialog.
  97.  
  98. HISTORY: As noted above, the inspiration for X-Master was from various launching
  99. utilities for the Macintosh.  Since I was the original author of MultiMaster, a
  100. launching utility published as part of Now Utilities 2.0x and 3.0x (and now
  101. incorporated into NowMenus of NU 4.0x and beyond), it wasn't too great a leap to put
  102. together something similar when I decided to learn how to program for the Newton
  103. platform.  I hope that you will find this little utility useful!
  104.  
  105. SHAREWARE: If you like X-Master, please send $12 US to the address listed below.
  106. For those who prefer to register online, you can use Compuserserve's SWREG service.
  107. Simply type GO SWREG at the online prompt and follow the directions.  X-Master's ID#
  108. is 3620.
  109.  
  110. Don't forget to include your preferred email address so I can can contact you
  111. about updates, etc.  Also, please drop me a note with your comments or suggestions
  112. for improvements.  Any input would be appreciated!
  113.  
  114. X-Master 2.0 is FREE to users who registered version 1.0 up to November 15.  After that,
  115. the shareware fee for X-Master has been increased. Also, please note that the author
  116. address has changed.  
  117.  
  118. Compuserve Registration (SWREG) info: To avoid the hassle of registering your 
  119. software by mail (especially overseas users!), you can now register X-Master on
  120. Compuserve.  Simply type GO SWREG at a prompt and look for ID# 3620 or search
  121. for "X-Master".  Thanks again for your registrations!!
  122.  
  123. ABOUT THE AUTHOR: As mentioned above, I got my start in the Mac programming
  124. world by writing a little hack that could launch programs under MultiFinder.
  125. This hack eventually grew to become MultiMaster™.  Recently, most of my time has
  126. been occupied finishing my M.D.followed by Internal Medicine training at UC, San
  127. Francisco. I've since moved to Stanford University where I'm doing a Fellowship
  128. in Cardiology which not only includes clinical training, but also basic science
  129. research on the mechanisms and possible treatment of atherosclerosis (hardening
  130. of the arteries which can lead to heart attacks and strokes). The Newton
  131. technology has very clear application to all levels of the medical system from
  132. administration to "in-the-trenches" patient care.  At some point in the near
  133. future, I would like to become involved in medically related Newton projects
  134. either as a programmer or a consultant.  I'd love to hear from those with
  135. similar interests in applying Newton technology to the medical or scientific
  136. field.
  137.  
  138. If you have comments, suggestions, or bug reports, please send mail to: 
  139. Rich Guerra
  140. Impossible Dreams
  141. 2711 Brighton Place
  142. Fullerton, CA 92633
  143.  
  144. (Or better still, send email so I can easily answer!)
  145.  
  146. Electronic Mail Addresses:
  147. NewtonMail/eWorld: rguerra; CIS: 71041,1371; AppleLink: IMPOSSDREAMS; InterNet:
  148. rguerra@eWorld.com
  149.  
  150.  
  151. RELEASE HISTORY: 
  152. v2.0: 9/24 - upgrade released.
  153.  
  154. v2.0b2: 7/15/94 - Added Extras Button popup.  First PUBLIC beta release.
  155.  
  156. v2.0b1: 7/4/94 - Added new preferences to about box.
  157.  
  158. v2.0d1: 7/1/94 - Implemented "MultiMenus" to display LONG lists.
  159.  
  160. v1.0.1 6/24/94 - Minor Bug Fix.  Added the "noAutoClose" flag that eliminates the
  161. annoying "disappearing X-Master" problem when the Card applet is opened.  Added
  162. a version string to the about box.
  163.  
  164. v1.0 6/6/94 - first public release
  165.  
  166. ==============================================================================
  167. X-Master is Copyright © 1994 Ricardo Guerra, Jr. & Impossible Dreams.  All
  168. Rights Reserved.
  169. ==============================================================================
  170.